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Willkommen zu einer neuen Ära der 
Amiga-Programmierung. 


compile- engl.: Zusammen¬ 
stellen, Zusammentragen 

Programm, das Befehle (Quell¬ 
text) einer Hochsprache in 
Maschinensprache (Objekt¬ 
code) übersetzt. 


Make- engl.: machen, an fer¬ 
tigen, hervorbringen. 

Bei Compilersystemen veran¬ 
laßt Make, daß die tatsächlich 
veränderten Programmodule 
kompiliert werden. 


Mit der beiliegenden Vorschau unseres brandneuen 
Compilersystems lernen Sie die Fähigkeiten einer 
fortschrittlichen Programmiersprache kennen. 

In einer sogenannten integrierten Umgebung finden 
Sie alles, was Sie zum Programmieren benötigen. 

Herzstück und Steuerzentrale ist die Projektverwal¬ 
tung, von der aus alle weiteren Komponenten des 
Systems aufgerufen und mit Daten versorgt werden. 

Die Projektverwaltung ist nicht einfach nur ein bes¬ 
seres Make, sondern eine Verwaltung für alle Ihre 
Programmodule. Dazu zählen nicht nur Quelltexte 
und Objekt-Bibliotheken, auch die Programmdoku¬ 
mentation, zum Programm gehörende Arexx-Scripts, 
Bilder und Ressourcen werden darin verwaltet. 
Selbstverständlich werden von hier aus auch alle 
Compiler-, Editor- und Projekt-Optionen eingestellt. 

Wenn Sie jetzt der Meinung sind, daß das alles 
bestimmt viel zu kompliziert zu bedienen ist, kann 
ich Sie beruhigen. Blättern Sie doch einmal auf die 
nächsten Seiten, dorthin, wo das erste Beispiel 
beschrieben wird. Anhand der Bilder können Sie 
bereits sehen, daß alles sehr einfach und intuitiv 
bedient werden kann. 


Syntax 

Formale Regeln, die in einer 
Programmiersprache eingehal¬ 
ten werden müssen. 


Eine weitere Komponenten im System ist z. B. der 
Editor mit seiner besonderen Fähigkeit, Schlüssel¬ 
worte und Syntax-Eigenschaften farbig im Text her¬ 
vorzuheben. Die Farbmarkierung hilft nicht nur, 
daß Sie ihr Programm durch die besondere Struktu¬ 
rierung besser lesen können, sie hilft auch dabei, 
Fehler bei der Erfassung Ihrer Quelltexte zu vermei¬ 
den. Sobald ein Schlüsselwort oder eine Amiga- 
Funktion komplett eingegeben ist, wird das Wort 
farbig markiert und Sie haben die Sicherheit, daß die 
Schreibweise korrekt ist. 


Bevor wir zum eigentlichen Arbeitspferd, dem Com¬ 
piler kommen, möchte ich kurz auf den außerge- 
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Debugger - engl.: Entwanzer 

Programm zum Suchen und 
Entfernen von Programmierfeh¬ 
lern ("Bugs"). 


Exception - engl.: Ausnahme 

In dem beschrieben Fall betrifft 
dies die CPU, die in den Aus¬ 
nahmezustand versetzt wird, 
was im Normalfall (wenn es 
nicht abgefangen wird) in 
einem GURU (Systemabsturz) 
endet! 


wohnlichen Debugger eingehen. Außergewöhnlich 
deshalb, weil Sie den Unterschied, ob nun der Editor 
läuft oder ob es doch der Debugger ist, kaum bemer¬ 
ken werden. Der Debugger nutzt nämlich die Fähig¬ 
keiten des Editors. Die Quelltexte des zu debuggen- 
den Programmes werden im Editorfenster angezeigt. 

Wie gewohnt können Sie nun darin blättern, Unter¬ 
brechungspunkte setzen und Programmfunktionen 
oder Variablen suchen. Wie gewohnt wird auch die 
Quelltext-Strukturierung durch die farbige Textdar¬ 
stellung unterstützt. Sie können so wesentlich flüssi¬ 
ger arbeiten. 

Wir hatten natürlich bei der bisherigen Planung 
auch einen Hintergedanken. Für zukünftige Versio¬ 
nen ist es vorgesehen, daß Änderungen, die man 
während des Debuggens in den Quelltext einfügt, 
direkt wieder übersetzt werden können. Das lästige 
Beenden des Debugger, das Neukompilieren und 
erneute Starten hat dann ein Ende. Schöne Aussich¬ 
ten, die die Software-Entwicklung auf dem Amiga 
noch effizienter gestalten. 

Eine sehr große Hilfe für den Debugger ist auch 
unsere RunShell. Durch sie ist es möglich, die typi¬ 
schen Programmierfehler bei der Betriebssystempro¬ 
grammierung schnell zu lokalisieren. 

Ein Beispiel für Fehler, die immer wieder gemacht 
werden, ist am besten mit den Funktionen aiioc- 
Mem() und FreeMemO zu beschreiben: Speicher zu 
allozieren, ist eine einfache Sache, ihn aber wieder 
an das System zurückzugeben, stellt für viele Pro¬ 
grammierer ein großes Problem dar. Entweder wird 
vergessen, alle Speicherblöcke freizugeben oder der 
freigegebene Block ist zu groß oder zu klein, was 
meist in einer CPU-Exception endet. Die RunShell 
führt zu allen wichtigen Systemroutinen Protokoll, 
die etwas mit den Systemressourcen zu tun haben. 
So kann genau dokumentiert werden, wann Funk¬ 
tionen zuwenig, zuoft oder mit fehlerhaften Parame¬ 
tern aufgerufen werden. Ein weiterer großer Vorteil 
der RunShell ist die Möglichkeit, jederzeit während 
des Programmablaufs den Debugger zu starten. Sie 
müssen sich also nicht bereits vor dem Programm 
Start entscheiden, ob Sie nun debuggen möchten, 
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oder ob das Programm im normalen Modus ablau¬ 
fen soll. Wechseln Sie einfach im Bedarfsfall in den 
Debugger. 


♦ 


Aber nun zum eigentlichen Gehirn des Entwick¬ 
lungspaketes, dem ANSI C/O Compiler. 

Der Begriff objektorientierte Programmierung ist in 
aller Munde. Kaum ein Softwarehaus entwickelt 
heute noch in ANSI C. Zumindest wird dieser Ein¬ 
druck vermittelt. Das Gegenteil ist jedoch der Fall. 
Alle benutzen zwar einen C ++ Compiler, aber der ist 
natürlich genauso gut geeignet, auch ANSI C Quell¬ 
texte zu übersetzen. 

Unser Augenmerk richtet sich deshalb auch an die¬ 
jenigen, die bisher mit ANSI-C gearbeitet haben, 
und bei einem Umstieg auf ein zukunftsicheres 
Compilersystem ihre Programme 1 zu 1 weiterver¬ 
wenden möchten. Der sanfte Umstieg ist mit 
StormC gewährleistet. 

Die C ++ -Implementation richtet sich nach den Vor¬ 
gaben von Bjarne Stroustrup und ist damit zum 
erweiterten AT&T Standard 3 kompatibel. 

Der Compiler generiert Code für alle Motorola 
680x0 CPUs einschließlich der 68060 CPU, die 
immer mehr auf Turboboards zum Einsatz kommt. 
Die grundsätzlich überragende Kompiliergeschwin¬ 
digkeit wird durch den Einsatz von vorkompilierten 
Headerdateien (precompiled Header) um Faktoren 
beschleunigt. Der integrierte Linker verarbeitet alle 
gängigen Bibliotheksformate (Standardformate, 
SAS/C, MaxonC^, ...) und ist dabei einer der 
schnellsten auf dem Amiga. 


StormC ist für alle Entwicklungsaufgaben geeignet, 
seien es Verwaltungs-, Grafik-, Musik- oder Spiel-Pro¬ 
gramme. Auch die Betriebssystem-Entwicklung ist 
für StormC kein Problem. 


Die vorliegende Preview-Version von StormC soll 
Ihnen bei der Entscheidung für Ihr zukünftiges 
Compilersystem helfen. Eine selbstablaufende 
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♦ 

Demoversion wäre dabei aber mehr als unsinnig. 
Schließlich wollen Sie auch eigene Projekte auspro¬ 
bieren und eventuell testen, wie sich das System 
gegenüber Ihrem alten verhält. Die Preview-Version 
von StormC bietet Ihnen daher die Möglichkeit, alle 
Funktionen des Compilers und der integrierten 
Umgebung genau unter die Lupe zu nehmen. 

Bitte bedenken Sie allerdings, daß es sich bei der 
vorliegenden Preview-Version nicht und das fertige 
Produkt handelt. In der ersten Version, die im Janu¬ 
ar '96 erscheinen wird, sind noch etliche Funktio¬ 
nen mehr enthalten und die Funktionsweise des 
Gesamtsystems noch harmonischer. Sollten eventu¬ 
ell einzelne Funktionen nicht so arbeiten, wie Sie es 
sich wünschen, oder haben Sie sonstige Verbesse¬ 
rungsvorschläge, scheuen Sie sich bitte nicht uns 
anzurufen oder uns zu faxen. Wir werden jeden 
Wunsch entgegen nehmen und mit unserem Pro¬ 
grammiererteam darüber beraten. 


Philosophisches 

Eine Programmiersprache ist für den Programmierer 
ein Hilfsmittel, um auszuführende Aktionen zu spe¬ 
zifizieren. Sie stellt eine Menge von Begriffen zur 
Verfügung, mit denen der Programmierer die Mög¬ 
lichkeiten der Problemlösung bedenken kann. Aber 
nicht nur die Sprache und ihre sprachlichen Hilfs¬ 
mittel sind für den Programmierer wichtig, auch die 
Implementation der zugehörigen Programmier- 
Hilfsmittel auf der jeweiligen Hardware-Plattform 
spielen eine entscheidende Rolle für den Erfolg. 

Ein Aspekt bei der Sprachwahl erfordert daher eine 
Sprache, die im Idealfall nah an der Maschine ist, so 
daß mit allen wichtigen Aspekten der Maschine, für 
den Programmierer transparent und nachvollzieh¬ 
bar, handlich und effizient umgegangen werden 
kann. C ist eine Sprache, die primär unter diesem 
Aspekt entworfen wurde. 

Der zweite Aspekt erfordert eine Sprache, die nah 
am Problem ist, so daß die Konzepte der Problemlö- 
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sung direkt und schlüssig formuliert werden kön¬ 
nen. Die Sprachelemente, die in C ++ über C hinaus¬ 
gehen, wurden in Hinblick auf diesen zweiten 
Aspekt entworfen. 

Der dritte Aspekt betrifft die Implementation des 
Compilersystems und seiner Hilfsmittel. Die Pro¬ 
grammierumgebung sollte dem Programmierer die 
Möglichkeit geben, sich ganz auf die Problemlösung 
zu konzentrieren. Die einfache und logisch durch¬ 
dachte Handhabbarkeit vom StormC erfüllt diese 
Anforderung. 


Anforderungen 


In der folgenden Liste finden Sie die Minimal-Konfi¬ 
guration zum Betrieb von StormC: 

• Amiga mit Festplattenlaufwerk 

• Kickstart/Workbench 2.0 (v37) 

• 3 MB Hauptspeicher 

• 5 MB Festplattenspeicher 


Mit dieser Zusammenstellung kann zwar entwickelt 
werden, aber die Projektgröße ist sehr begrenzt. Des¬ 
weiteren können nicht alle Debugger-Eigenschaften 
genutzt werden, wenn nicht wenigstens eine 68030 
CPU mit MMU eingesetzt wird. 


Am besten eignet sich die folgende Konfiguration: 

• Amiga mit mind. 68030 inkl. MMU 

• Kickstart/Workbench 3.0 besser 3.1 

• 8 MB freier Hauptspeicher 

• 30 MB freier Festplattenspeicher 

In dieser Konfiguration werden der Compiler und 
auch die Shell kaum über zu wenig Speicher klagen. 


Als Faustformel können Sie sich jedoch merken: 
VIEL HILFT VIEL! 
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Installation 

Zur Installation auf Ihre Festplatte wird der Commo- 
dore Installer eingesetzt. Dieses Installationstool hat 
sich mittlerweile als Standard-Installierer durchge¬ 
setzt und sollte Ihnen in der Bedienung bekannt 
sein. Wir mußten uns für die englischsprachige Ver¬ 
sion entscheiden, da beim Einsatz der deutschspra¬ 
chigen eventuell Probleme auftreten können. Zum 
besseren Verständnis finden Sie hier die Übersetzung 
der wichtigsten Tasten: 


Proceed 

OK und weiter. 

Die abgefragte Aktion wird ausgeführt. 

Abort Installation 

Installation beenden. 

Die Installation wird nicht fortgeführt. 

Parent Drawer 

Mutterverzeichnis 

Den Inhalt des nächst höheren Ver¬ 
zeichnisses anzeigen. 

Show Drives 

Laufwerke 

Alle Laufwerke anzeigen. 

Make New Drawer... 

Erzeuge neues Verzeichnis. 

Legt einen neuen Ordner im angegebe¬ 
nen Pfad an. 

Help... 

Das sollten Sie auch ohne Übersetzung 
wissen! 

Cancel 

Aktion abbrechen. 




o 


öl 


StormC_Di$ki 


Legen Sie bitte die erste Diskette der Preview-Version 
in Ihr Diskettenlaufwerk und Doppelklicken Sie auf 
das Disketten-Ikon. 

Bevor Sie nun mit der Installation beginnen, sollten 
Sie sich die Datei "Liesmich" auf der Diskette durch¬ 
lesen. Hierin sind wichtige Neuerungen und Tips 
beschrieben, die leider nicht mehr mit ins Hand¬ 
buch übernommen werden konnten. 
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■ .sonstiges RAM 


'm- ;«’ s 


StormC_Di3k1 


□ | StormC_Dräkl 80 % voll, 165 K fr«, 672 | E31Ö 



IHSftH 

Install StormC-HD 

Liesmich S® 

y 


Script - engl.: Schriftstück, 
Manuskript 

In unserem Fall handelt es sich 
um den interpretierbaren 
Installations-Quelltext zum 
Installieren von StormC. 


Doppelklicken Sie jetzt auf das Ikon "Install 
StormC-HD". Bitte haben Sie einen Augenblick 
Geduld, bis das Installationsprogramm und das - 
Script geladen sind. 



Bitte folgen Sie den Anweisungen des Installations¬ 
programmes. Sollten Sie einmal nicht weiter wissen, 
klicken Sie einfach auf den "Help"-Knopf und lesen 
Sie nach, was zu tun ist. 

Nach erfolgreicher Installation erhalten Sie eine ent¬ 
sprechende Meldung vom Installationsprogramm. 

Sollte die Installation nicht positiv verlaufen sein, 
wiederholen Sie bitte den Vorgang mit eingeschalte¬ 
ter "Log-Datei"-Generierung. Die Option "Log all 
actions to: Log File" kann in dem Optionen-Fenster 
eingestellt werden, das nach dem Begrülsungs l en- 
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ster angezeigt wird. Nach der erfolglosen Installation 
können Sie dann im Installationsprotokoll nachle- 
sen, was nicht funktioniert hat. Beheben Sie bitte 
das Problem und installieren Sie erneut. 


Was tun bei „unlösbaren" Problemen 

Sollten Sie nicht nur bei der Installation Schwierig¬ 
keiten mit der Software haben, scheuen Sie sich 
bitte nicht, uns anzurufen. Wir sind gerne bereit, 
Ihnen zu helfen und gemeinsam mit Ihnen die Pro¬ 
bleme aus der Welt zu schaffen. 


Hier können Sie uns erreichen: 

Werktags zwischen 9:00 und 17:00 Uhr unter: 
06007/930051 


Per E-Mail: 


CompuServe: 100654,3133 

Internet: 100654.3133@compuserve.com 
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Tutorial 


Im Tutorialteil des Handbuchs erfahren Sie alles 
über den Umgang mit dem Programm. Anhand ein¬ 
drucksvoller Beispiel wird Ihnen die Funktionsweise 
des Compilersystems beigebracht. Sie lernen den 
Umgang mit der Projektverwaltung, wie man Quell¬ 
texte erfaßt und schließlich, wie man den Compiler 
startet. In ein weiteres Beispiel beschreibt den 
Umgang mit dem Debugger. Ein kleines Demopro¬ 
gramm wird erstellt und Schritt für Schritt im 
Debugger abgearbeitet. 

Sie erhalten durch das Tutorial einen umfassenden 
Eindruck des Compilersystems und werden, nach 
dem Sie es durchgearbeitet haben, nie mehr mit 
einem anderen Compilersystem arbeiten wollen. 


Programmstart 

Im ersten Beispiel lernen Sie, wie Sie ein neues Pro¬ 
jekt erstellen, den Programm-Quelltext erfassen und 
das Programm kompilieren und starten. 



StormCPP 


Starten Sie bitte StormC durch Doppelklick auf das 
Programm-Ikon (siehe nebenstehende Abbildung). 
Das Programm finden Sie in der Schublade, in das 
Sie das Compilersystem installiert haben. 


Während des Starts sehen Sie eine Willkommens¬ 
meldung, die solange auf dem Bildschirm zu sehen 
ist, bis alle Programmkomponenten geladen sind. 

Nach dem Laden aller Komponenten wird am obe¬ 
ren Bildschirmrand eine Piktogrammleiste ange¬ 
zeigt, die die wichtigsten Funktionen der integrier¬ 
ten Oberfläche zum schnellen Anklicken bereithält. 
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Die Piktogrammleiste stellt folgende Funktionen bereit: 


Neuer Quelltext 
Quelltext luden 

Quelltext speichern 


IR K Q S 4 £*■ « 


öffnet ein neues Editorjenstelr 
h -—H- [- 1 - 

--- 1 


Hilfstextzeile Neues Projekt Make + Start im Debugger 

Projekt laden Make + Programmstart 

Projekt speichern Make 


Wir beginnen selbstverständlich mit dem typischen 
Beispiel beim ersten Kontakt mit einem neuen Pro¬ 
grammiersystem: "HELLO WORLD". 


Erzeugen eines neuen Projektes 



Klicken Sie bitte in der Piktogrammleiste auf das 
Ikon "Neues Projekt". Ein neues Projektfenster wird 
angezeigt. 
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Workbench Screen 



Storm C 

1^3 
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StormCPP 


Code 

Text 



Was ist ein Projekt? 

In einem Projekt wird alles zusammengefaßt und 
verwaltet, was zu Ihrem Programm dazugehört: C-, 
C ++ -, und Assembler-Quelltexte, Headertexte, Objekt- 
Dateien, Linker-Bibliotheken, Dokumentationen, 
Grafiken, Bilder und sonstigen Ressourcen. Durch 
die Trennung in verschiedene Sektionen bleibt die 
Dateien-Sammlung übersichtlich. Die Projektverwal¬ 
tung ist aber auch ein grafisch orientiertes Make. 


Make und Modulabhängigkeiten 

Bei jedem Compilerlauf werden die Abhängigkeiten 
zwischen ".o"-, ".h"-, ".ass"-, ".asm"-, ".i"-und 
". c " -Dateien (selbstverständlich auch ". cc •• oder 
".epp") ermittelt und der Projektverwaltung mitge¬ 
teilt. So weiß die Projektverwaltung ganz von allei¬ 
ne, daß ein C-Quelltext neu kompiliert werden 
muß, wenn eine " .h" -Header-Datei verändert 
wurde, die im " .c"-Quelltext „includet" wird. 

Bei Klick auf die Piktogramme „Make" oder „Run" 
werden zuerst alle Abhängigkeiten geprüft und dann 
von Make entschieden, welche Programmodule neu 
kompiliert werden müssen und welche aktuell sind. 
„Run" unterscheidet sich gegenüber „Make" ledig¬ 
lich dadurch, daß bei erfolgreicher Kompilation das 
Programm automatisch gestartet wird 
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StormC starten, Ihr erstes Programm, . 


" ♦ 

Projekt speichern und neues Verzeichnis anlegen 

Als nächsten Schritt speichern Sie bitte das Projekt 
und legen dabei gleichzeitig ein neues Datei-Ver¬ 
zeichnis an. 



Klick Sie bitte auf das „Projekt speichern"-Pikto- 
gramm. Wählen Sie bitte in der angezeigten ASL- 
Standard-Dateiauswahl das "StormC:" Verzeichnis 
aus und geben den Datei-Pfad und -Namen -Hello 
worid/Heiio World" in das Dateinamen-Eingabefeld 
ein. 


Die Endung ".f kann manuell 
auch über die Tasten ALT+P 
eingegeben werden. 


Die Endung " .gi" wird automatisch angehängt und 
symbolisiert Ihnen, daß es sich bei der jeweiligen 
Datei um ein StormC-Projekt handelt. 


Schublade 'STORMC;Hello World' existiert nicht, neu anlegen? 



Sie werden sich sicher wundern, warum das leere 
Projekt gespeichert werden soll; auch wenn das Pro¬ 
jekt noch keinen Inhalt hat, ist es sinnvoll bereits zu 
Beginn einen eindeutigen Projektpfad anzugeben. 
Die Dateinamen der Quelltexte und andere Ressour¬ 
cen können dann relativ zum Projektpfad im Projekt 
aufgenommen und gespeichert werden. Andernfalls 
würde der absolute Pfad verwendet. Ein weiterer 
Vorteil ist, daß beim Hinzufügen von Projektdateien 
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♦ 


bereits der entsprechende Pfad im ASL-Dialog einge¬ 
tragen ist. Sie sparen sich dadurch die Pfadsuche. 


Quelltext erfassen 


Jetzt kommen wir zu der eigentlichen Programmie¬ 
rung. Öffnen Sie jetzt ein neues Quelltext-Fenster 
mit Klick auf das Piktogramm "Neuer Quelltext". 

Bevor Sie nun anfangen Text einzugeben machen 
Sie sich bitte kurz mit den Bedienelementen des Edi¬ 
tors vertraut. 

Zeilenendemarkierung 
Tabulatoranzeige 
Leerzeichenanzeige 
Automatische Einrückung 
Überschreiben 
Textsperre 

Textänderungsindikator 

Zeilen-/Spaltenanzeige 



Tippen Sie jetzt bitte folgende Programmzeilen ein: 


/* Hello World 

Demo-Programm zum Preview-Tutorial */ 

#include <stdio.h> 

void main( void) 

{ 

printf("Hello World\n"); 

} 
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StormC starten, Ihr erstes Programm, ... 


Speichern Sie jetzt bitte das eingegebe Programm 
unter dem Namen "Hello worid.c" im Verzeichnis 

"Hello World". 

Rufen Sie dann den Menüpunkt „ Projekt/Fenster 
hinzufügen" auf. Der Dateiname erscheint nun in 
der Quelltext-Sektion des Projektfensters. Anhand 
der Dateiendung entscheidet die Projektverwaltung, 
in welche Sektion die Datei abgelegt wird. 


Bevor Sie nun den Compiler starten, sollten Sie 
noch einen Dateinamen für das Programm angeben. 
Andernfalls erzeugt der Linker automatisch den Dat¬ 
einamen "A.Out". 


Wählen Sie dazu aus dem Menü „Projekt" den Ein¬ 
trag „Programmname wählen" aus. Achten Sie bitte 
darauf, daß das Projektfenster das aktive Fenster ist. 

Ihr Projektfenster sollte jetzt so aussehen, wie in der 
nächsten Abbildung dargestellt. 


Workbench Screen 


Storm C 

l<& 

\ 

e 





■w 

StormCPP 


□ | /HeHo World/Hello World.fl 


Workl 

m 


Datei 


Code 


Hello Worid.c 


120 


'v r 

Hello World 

120 




Work2 




l* Hello World 

Demo-Programm zum Preview Tutorial */ 
; ll>nc'vd* <stdio.h> 
wid main< void) 

<"Hello World"); 
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♦ 

Quelltext kompilieren 

Mit Klick auf das Projekt-Piktogramm „Make" wird 
das Compiler-Fehlerfenster geöffnet und der Quell¬ 
text vom Compiler übersetzt. Während der Überset¬ 
zung werden vom Compiler Statusmeldungen im 
Fehlerfenster ausgegeben. 




Wird vom Compiler ein Fehler entdeckt, erfolgt die 
Ausgabe des entsprechenden Fehlers in der Anzeige 
darunter. Sie erhalten hier eine sehr detaillierte Feh¬ 
lerbeschreibung und die Angabe der Zeilennummer 
und des jeweiligen Quellsources. 


Workbench Screen 


Storm C 


KlR-1 alsHsH £ 


□ | /HelloWorld/Hello World .fl 



Fehler: Unbekannte Funktion "print" 

, Zeile 8 : printCHeilo WorldVOi 


Starten... | Debug... | 


HJ ^<J>d 


r 


j. 


System2.x 

S 


Cinema 


e|t|s|To|r| r 


X: £] 


/* Hello World 

Demo-Programm zum Preu lew Tutorial */ 
# - <stdlo.h> 

'ou» maln< 

rint(."Hello World\n">; 
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StormC starten, Ihr erstes Programm, . 


" ♦ 


Im obigen Beispiel wurde absichtlich ein Fehler in 
der Zeile 8 eingefügt. Aus dem Funktionsnamen 
printf wurde das letzte Zeichen gelöscht. Zwar läßt 
sich bereits beim Löschen des Zeichens erkennen, 
daß ein Fehler vorliegen muß, da die farbliche 
Kennzeichnung weggenommen wird aber für die 
Demonstration des Fehlerfalles soll das Programm so 
kompiliert werden. 

Sobald der Compiler auf den Fehler trifft, wird eine 
entsprechende Fehlermeldung im Fenster ausgege¬ 
ben. 

Selbstverständlich genügt ein Doppelklick auf den 
jeweiligen Fehler und die Projektverwaltung lädt 
den Quelltext und zeigt die Fehlerstelle im Editor- 
Fenster an. Sie können dann die Korrektur vorneh¬ 
men und den Compilerlauf erneut starten. 
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2 Tutorial 


Übersetztes Programm starten 

Bei erfolgreichem Compilieren und Linken wird der 
während des Compilierens nicht zugängliche Knopf 
„Starten" zugänglich und anklickbar. Mit Klick auf 
diesen Knopf oder auf das Projekt-Piktogramm 
"Run" wird das Programm gestartet. 

Wird statt des „Make"- das „Run"-Piktogramm 
angeklickt, prüft die Projektverwaltung zuerst, ob 
bereits alle Module kompiliert sind. Ist dies nicht 
der Fall, wird automatisch der Compiler für alle 
noch nicht übersetzten Projektmodule gestartet. 
Nach der erfolgreichen Übersetzung, wird dann das 
Programm automatisch gestartet. 



Die RunShell 

Einen Programmstart aus der Projektverwaltung ist 
ein sehr komplexer Vorgang, auf den ich hier näher 
eingehen möchte. 

Wie Sie sicher bemerken, wird beim Starten ein wei¬ 
teres Fenster geöffnet, die sogenannte „RunShell". 


Workbench Screen 
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StormC starten, Ihr erstes Programm, . 


- ♦ 

Selbstverständlich ist es auch möglich, das Pro¬ 
gramm einfach so zu starten, aber in einer Entwick¬ 
lungsumgebung wünscht man sich ja, daß das Pro¬ 
gramm auch nach dem Starten noch beeinflußt und 
debuggt werden kann. So ist es z. B. möglich, auch 
noch nach dem Starten des Programmes den Debug¬ 
ger aufzurufen, um das Programm genauer unter die 
Lupe zu nehmen. Auch wenn ein Programmfehler 
auftritt, der eine CPU-Exception auslöst, wird dieser 
abgefangen und in den meisten Fällen die Möglich¬ 
keit geboten, die exakte Fehlerstelle im Quellcode zu 
begutachten. 

Eine weitere wichtige Eigenschaft ist das sogenannte 
„Resourcen Tracking", das von der RunShell vorge¬ 
nommen wird. Hierbei werden die Systemfunktio¬ 
nen dokumentiert, die mit dem „Resourcen-Hand- 
ling" zu tun haben (AllocMem, OpenWindow, 
Open, ...). Beim Beenden des Programmes kann so 
genau festgestellt werden, welche Ressource nicht 
oder welche zuviel freigegeben wurde. Selbstver¬ 
ständlich wird auch hierbei direkt die Quelltextstelle 
angezeigt und der Fehler kann gleich geändert wer¬ 
den. 

Desweiteren bietet die RunShell die Möglichkeit, die 
Signale „Ctrl-C, Ctrl-D, Ctrl-E, Ctrl-F", die norma¬ 
lerweise nur per Shell (CLI), dem von eben dieser 
aus gestarteten Programm übermittelt werden kön¬ 
nen. 

Auch die Priorität, mit der das System das Programm 
bearbeiten soll, kann in Schritten zwischen -128 bis 
+127 eingestellt werden. 

Der Knopf „Pause" hält das Programm in dem gera¬ 
de aktiven Zustand an. „Pause" ist ein Toggle- 
Knopf, das heißt er wechselt bei jedem Klicken den 
Zustand. Ein Klick aktiviert den Knopf und das Pro¬ 
gramm wird angehalten. Ein weitere Klick und das 
Programm läuft wieder weiter. Der Knopf wird dann 
wieder inaktiv angezeigt. 

Mit Klick auf den Knopf „Kill" wird das Programm 
gleich beendet. Alle aufgezeichneten Ressourcen 
werden zuvor freigegeben (Speicher und Signale 
werden freigegeben, Screens, Fenster, Requester und 
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2 Tutorial 


♦ 


Dateien geschlossen). Auf diese Art und Weise sind 
Programmleichen ausgeschlossen. Durch versehent¬ 
lich programmierte Endlos-Schleifen entstehen 
leicht solche Programmleichen. Die Methode ist 
wesentlich zeitsparender und damit effizienter als 
den Amiga neu zu starten. 

In unserem Beispiel wird das Programm allerdings 
so schnell abgearbeitet, so daß das Fenster der 
RunShell nur sehr kurze Zeit auf dem Bildschirm zu 
sehen ist. Im nächsten Beispiel werden Sie länger 
mit der RunShell konfrontiert, da Sie hierbei mit 
dem Debugger arbeiten werden. 

Bei dem Ausgabefenster, das immer noch den Inhalt 
"Hello World" anzeigt, handelt es sich um ein nor¬ 
males Console-Fenster, das auch nach dem 
Programmende noch geöffnet bleibt. Console-Fen¬ 
ster werden automatisch geöffnet, wenn vom Pro¬ 
gramm Ausgaben auf die Standard-Ausgabe wie z. B. 
mit der Funktion print f gemacht werden. Klicken 
Sie einfach auf das Schließfeld des Fensters und es 
wird geschlossen. 
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Programme debuggen 


Debugger 


♦ 


Ein Debugger wird zur schnellen Fehlersuche 
benötigt. Er bietet die Möglichkeit, geziehlt Unter¬ 
brechungspunkte in Ihren Programmen zu definie¬ 
ren und an diesen „Breakpoints" Veränderungen 
von Variablen, Strukturen und Klassen zu beobach¬ 
ten. Auf diese Weise lassen sich Fehler einkreisen 
und können schnell behoben werden. 



Um Ihnen das Arbeiten mit dem Debugger zu 
demonstrieren, laden wir ein bereits vorgefertigtes 
Projekt und kompilieren es. 

Im Verzeichnis Beispiele finden Sie den Ordner 
Colorwheel. Bitte öffnen Sie den Ordner auf der 
Workbench. Das Bild auf Ihrem Monitor sollte so 
aussehen, wie in der unteren Abbildung dargestellt. 


Aniga Workbench 1.756.648 Chip-RAM 4.792.048 sonstiges RAM 


Storm C _ | ca 
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Dl cotor ieona 



Doppelklicken Sie auf das Projekt-Ikon im Work- 
bench-Fenster. Das Projekt wird geladen und ange¬ 
zeigt. Wählen Sie bitte in „Menü-Einstellungen" 
den Eintrag „Projekt..." aus. Wechseln Sie dann mit 
dem Cycle-Menü oben links zu den Einstellungen 
für die C/C ++ Optionen. 
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2 Tutorial 


♦ 


Workberich Screen 


cq a | /Beispiele/Colorwheel/Color 

- Datei- - - 


felRlR-l Ql S*l sH 


amiqa.lib 


Einstellungen f& Projekt /Bebptete/Cotorv^Cotor^ _L 


CJ DD4^^ptionen Einstellungende3 Compilerverhaltens 


CI ANSIC I 

_| Unterbrechbar 

^1 32 bit Multiplikation 

_| Code optimieren 

C | Motorola 68000 

1 Alle Templates erzeugen 
QHi Exceptions benutzen 


CI Grone Debugdateien | 

C1 Mathematik Bibliotheken j 

C | großes Datenmodell | 

_| Symbolhunks schreiben 

CI Ohne Asmtext | 



Abbrechen | 


Wie Sie erkennen können, ist bereits voreingestellt, 
daß für alle Module große Debugger-Dateien (inkl. 
aller Include-Dateien) gespeichert werden sollen. 

Starten Sie nun den Compiler mit Klick auf das 
Debugger-Piktogramm. Genau wie beim Klick auf 
das Run-Piktogramm, wird auch hierbei zuerst 
geprüft, ob für alle oder für einzelne Module bereits 
Debugger-Dateien erstellt wurden, und eventuell 
neu kompiliert werden müssen. Nach dem Linken 
wird das Programm direkt im Debug-Modus gestar¬ 
tet. 


Bis zum Breakpoint gehen 
Einen Schritt gehen 
Übergehe Unterprogramm 
I Gehe bis Unterprogrammsende 
| Zeige Programmzähler 


Prcgr 


3FTS 

2E 


■ 

f\ 

iji Cc 

£ 



k 

ül 


I ölsHsH ^|«iM F 

heel| g]|iB 


lj n pa H ■ Ki|1 1 1 ■ ii-i i[ 


r~ iP 

11 c w- c (II 


\ - 


ejT|s|i]o|fiJ 


Hl 


exltvalue = RETURN_FRIL; 

i i f. tnHn t tm r" lritui ■! i on Ubrar 
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Programme debuggen 


♦ 

Je nach Voreinstellung wird das Modul-, Aktive- 
Variablen- und Überwachte-Variablen-Fenster geöff¬ 
net. 

Desweiteren wird der Quelltext des Moduls, das die 
main-Funktion enthält, geöffnet und der Quelltext 
ab der main-Funktion angezeigt. 


Workbench Screen 


Storm C 

«IfilRl olsHsH 

Programm ColorWheel _ 


4nSI P 


o | /colorwheel/ColorWheel.H 

düS-—- 


~c5dT“ 


Text 


I mlgsg 



n 1 überwachtel ED 1 



j. amiqa.lib_ 

Qi! Hv) 


1 ColorWheel .c 


j e 

> 7366 


ColorWheel 

A 







<" intuitlon.Ilbrary'\39 
(“graphlcs.IIbrary“,39)) 

<”gadgets/colorwheai.g 
("gadget s/g radien t sl 
(modelD)) 

■ (displayhandle,< 
Dlmenslonlnfo), 


if (IntuitlonBase = 
if (GfxBase = 
if (Colorl'lheeiBase = 
tf (GradlentSllderBase= 
if (displayhandle = 
if (gdldres= 

sizeof<Ätruct . . 

DTflG_J)IMS,NULL)) 

maxdepth ■ dIrnensIon Info.MaxDeplh; 

Myscreen = (NULL, 

Sfi_Depth, maxdepth, 

Sfl_SharePens, TRUE, 

SBJ. IkeWorkbench, TRUE, 

Sft_In t e r leaoed, TRUE, 

SRTltle, “ColorWheel Soreen", 

Tfl5j>0NE); 


o I Aktive Variablen 


ImlPl 


f (Myscreen) 


all ■ 1 h| w 

C»t CI Öls 

na H!Low llllllHighillill 


Myscreen 

Screen * 

O0X7C3O560 —> {} 

J 

Mywindow 

Window “ 

00x7c05ebe —> {} 


msg 

In tui Message “ 

00x7bfedO4 —> {> 


colwheel 

Gadget 

Gadget “ 

0OX7CO563C —> {} 


gradslid 

00X7800810 —> {} 

s 

rolortabfe 

<l>l 

unsigned long[96] 

mmmmmm < I > 

{ 1431 655765, 1431655765, 143161 

A 

V 


/* Get colors and set up gradlent sllder as co 

/# get the RGB components of color 0 */ 

(Myscreen->Vlev/Port .ColorMap,0L,32L,co ~ 


Sie erkennen, daß die Quelltextanzeige leicht verän¬ 
dert dargestellt wird. Die erste Textspalte verschiebt 
Spalte für Breakpoints s i c h dabei nach rechts, so daß eine weitere Spalte für 

die Unterbrechungspunkte angezeigt werden kann. 
Jeder Unterbrechungspunkt in der Spalte steht vor 
einer Quelltextzeile, an der das Programm angehal¬ 
ten werden kann. Wenn Sie mit der Maus auf einen 
dieser Punkte klicken, wird dieser mit einem diago¬ 
nalen Kreuz markiert und ist damit ein aktiver 
Unterbrechungspunkt. 


Bitte setzen Sie einen Unterbrechungspunkt direkt 
nach dem OpenScreen-Aufruf. 
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2 Tutorial 


♦ 

Sollte das Fenster der aktuellen Variablen nicht 
geöffnet sein, öffnen Sie es bitte durch Auswählen 
der Menüleiste „Fenster/Aktuelle Variablen 

Ihr Bildschirm sollte nun so aussehen, wie in der 
nächsten Abbildung dargestellt. 


Workbench Screen 




CQ 

Storm C 

|cQ|a| /color wheel/ColorWheel .fl 



1 EDI IQ 

1 1 —b 1 1 —9 1 1 rv. 1 


r<vi* 

,, JO?# 



Programm ColorWheel 



if (IntuitionBase 
if (GfxBase = 
itf (ColorWheelBase = 
tf (GradientSliderBase= 

if (displayhandle * -- 

If (gdidres= (displayhandle,( 

sizeof(struct Dimensioninfo), 

DTflG J> IMS,NULL>> 

< 

maxdepth = dimensioninfo.MaxDepth; 

Myscreen = (NULL, 

Sfi_Depth, maxdepth, 

Sfi_Sha rePens, TRUE, 

SRJL ikeWo r kbenoh, TRUE, 

Sfi_Interleaoed, TRUE, 

Sfi_Title, "ColorWheel Screen", 

TRG_PONE)j 


aJilllll* 

je»,. Bl as 

m |L»|r 

_|High |8 


Myscreen 

Screen* 

00x78f534a —5 

0 

J 

Mywindow 

Window x 

00x78e0000 —: 

>{) 


msg 

Intui Message * 

00x78f406C —> 

0 


colwheel 

Gadget * 

00x7ae8be1 —> 

ü 

i 

gradslid 

Gadget * 

Q0X78f56be — > 

{} 

1 

colortable 

- » <\ > 

unsigned long[9G] 

-jbwnmnm <1 > 

{0, 32767, 65535, 4294967295, 421 

ua 


f (Myscreen) 

/# Get oolors and set up gradient tlider as color Ö. 
/* get the RGB components of color 0 */ 


Klicken Sie nun in der RunShell auf das Piktogramm 
„Gehe bis zum nächsten Breakpoint". 

Da Sie den Unterbrechungspunkt unmittelbar nach 
dem Funktionsaufruf openscreen gesetzt haben, 
wird das Programm bis dorthin ausgeführt und ein 
neutraler Screen geöffnet. Die Programmausführung 
ist nun wieder gestoppt. 


Mit dem Ausführen der nächsten Funktion GetRGB 32 
wird ein Array von unsigned long-Typen mit Daten 
versorgt, was wir uns etwas genauer ansehen wollen. 
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Programme debuggen 


♦ 


Zeige Quelltextstelle 

Memberfunktionen eines Klassentyps an zeigen 
Inspizieren 

Hexeditor anzeigen 

Variable in Überwachenfenster übernehmen 
Variablentyp temporär ändern 

Grenzen der Arrayanzeige 


dge 


",:39LO II 

Aktive vari siblen 




aJIBjHjwl^t CI Orii 

Myscreen 
Mywindow 
msg 

colwheel 
gradslid 


Screen x 
Window x 
Intui Message x 
Gadget x 
Gadget x 

unsigned long[96] 


$ :: | Low Ift lif- i | High 


00x7C34a70 —> {} 

00x7ciea96 —> {} 
oox7bfed04 —> {} 
oox7cleai4 —> {} 

00X7800810 —> O 
{4294967295, 2147418112, 42949« 


5.1 > 


as color 0. */ 

\.<±>L^ 


Dazu ist es zunächst notwendig, daß Sie die Array- 
Variable coiortabie in ein Inspektorfenster stellen. 

Wählen Sie einfach im Fenster der aktuellen Varia¬ 
blen die Variable coiortabie mit der Maus an und 
klicken auf das Symbol "I" am oberen Rand des Fen¬ 
sters. 

Das nachfolgend abgebildete Fenster wird angezeigt. 
Sollten die angezeigten Werte bei der Darstellung 
auf Ihrem Monitor anders aussehen, liegt das daran, 
daß die Werte im Array zum jetzigen Zeitpunkt 
noch Undefiniert sind. Das heißt, daß dort der gera¬ 
de aktuelle Speicherinhalt angezeigt wird und dieser 
kann bei Ihnen andere Werte enthalten. 
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2 Tutorial 


Inspizieren (absteigen) 

I Vorherige (aufsteigen) 
Hexeditor anzeigen 


a e 


Variable in Überwachenfenster übernehmen 
Variablentyp temporär ändern 

Grenzen der Arrayanzeige 


a 1 fcolorwtheel; ColorWheel.fl 



Code 

Text 

n 1 

1 m 1 nj 

kl l 

Iß 

_ 

1 L 


1 


UlJjlJÜCwt C| Originai | Low |o j High 
ur>3igned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 
unsigned long 


81 
[i 
[2 
[3 
[4 
(5 
[6] 

[ 7 ] 

[ 8 ] 


LJLÜU; 


4234967295, Oxffffffff 
4294967295, Oxffffffff 
2147418112, 0x7fff0000 
4294967295, Oxffffffff 
4294967295, Oxffffffff 
2147418112, 0x7fff0000 
4294967295, Oxffffffff 
4294967295, Oxffffffff 
4294909752, Oxffffl f38 



Als nächstes führen Sie drei Einzelschritte aus und 
beobachten dabei genau, wie sich der Inhalt des 
Inspektorfensters verändert. Klicken Sie dazu zwei¬ 
mal auf das Symbol „Einen Schritt gehen" in der 
RunShell. Die Funktion GetRGB 32 lädt die in der 
Screen View-Struktur vorgegebenen Werte in das 
Array colortable. 

Anhand des Beispiels sehen Sie, wie einfach es ist, 
Variableninhalte mit dem Inspektorfenster anzeigen 
zu lassen. 

Setzen Sie nun weitere Unterbrechungspunkte und 
spielen Sie etwas mit den Debugger-Funktion, um 
damit vertraut zu werden. Sie werden sehr schnell 
feststellen, wie einfach das System zu bedienen ist. 

Um den Debugger zu beenden, genügt es, das im 
Debugger-Modus gestartete Programm zu beenden. 

Es werden automatisch alle Debugger-Fenster 
geschlossen und die RunShell beendet. 
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Menüleisten, Dialoge,.. 


Projektsektionen 


‘ ♦ 


Die einzelnen Sektionen eines Projektes werden 
automatisch durch die Dateiendungen und bei 
Dokumenten zusätzlich durch die Dateinamen 
erzeugt. Wird eine ".c" -Datei zu einem neuen Pro¬ 
jekt hinzugefügt, entsteht eine neue Sektion Quell¬ 
texte mit der entsprechenden Datei. Beim weiteren 
Hinzufügen von Quelltexten wird die Sektion ledig¬ 
lich erweitert. 


Faltenschalter - 
Bei Mausklick 
öffnet oder 
schließt sich die 
Falte. 


Sektionenbereich 


Codegröße der 

jeweiligen Textgröße in Byte 
Objektdateien 


\ Datei Code Text 

77 

amiqa.lib 




^Queftexte 




Demo.c 

Demo.cc 

Demo.ccp 

Demo.c++ 

Demo .epp 

77 

Demo.h 

Demo.hh 

Demo.hhp 

Demo.h++ 

Demo.hpp 




77 

Demo .asm 

Demo.ass 

Demo .s 




77 

Demo.i 




77 

Demo.dok 

Demo.doc 

Demo.txt 

Demo.readme 
lies mich 
liesmich 
readme 
read me 
read .me 
lies .mich 




77 

Demo.rexx 




V 7 

Irgendwas 




77 

Test.H 




V 

Test.quide 




V 7 

Demo 



<\ 


Finnin Hrruil/(•rhandbuch 


29 























3 Referenz 


Eigenheiten des Compilersystems 

Trotz der ANSI-Spezifikationen hat jedes Compiler¬ 
system so seine Eigenheiten. Eingeleitet werden 
diese Compilerspezifischen Dinge mit einem 

ttpragma. 


#pragma-Zeilen werden, genau wie #inciude, vom 
Preprozessor interpretiert und ausgeführt. Mit einem 
#pragma realisiert man dabei compilerspezifische 
Funktionen, die ausdrücklich nicht standardisiert 
sind. 


Compilermodus 

#pragma - ist ein nicht standardisiertes Feature und 
schaltet in StormC den Compiler um auf den ANSI- 
C Modus. 

#pragma + bewirkt das der Compiler den Quelltext 
im C ++ -Modus übersetzt. 


Daten in Chip- und Fast-Ram 

Die Architektur des Amiga ist etwas unkonventio¬ 
nell. So gibt zwei, manchmal auch mehr verschiede¬ 
ne Klassen von RAM. 

In der Praxis interessiert den Programmierer aber 
nur die Frage „Chip- oder Fast-RAM", denn Sie müs¬ 
sen dafür sorgen, daß Grafikdaten im Chip-Memory 
abgelegt werden. In StormC gibt es dafür die Prag- 
mas "chip" und "fast". 

Alle nach der Zeile 

#pragma chip 

deklarierten statischen Daten werden ins Chip-RAM 
geladen, 

ttpragma fast 

schaltet wieder in den normalen Modus, in dem die 
Daten irgendwo abgelegt werden, bevorzugt aber im 
Fast-RAM. 
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Menüleisten, Dialoge,.. 


' ♦ 


Breakpoin t-Kon trolle 

Die Breakpoint-Kontrolle hat nichts mit den Break¬ 
points im Debugger zu tun sondern vielmehr mit 
der Compilermöglichkeit, Programme zu erzeugen, 
die vom Benutzer abgebrochen werden können. Das 
ist einerseits während der Programmentwicklung 
angenehm, wenn man versehentlich eine Endlos¬ 
schleife programmiert hat, und andererseits ist es oft 
sinnvoll, wenn der Anwender eines Programms die 
Programmausführung gewaltsam abbrechen kann. 

Ein Programm fängt einen Abbruch ab, indem es an 
bestimmten Stellen, z.B. mindestens einmal inner¬ 
halb jeder Schleife, das Signalbit prüft, das durch die 
Tastenkombination <CTRL>+<C> oder das CLI-Kom- 
mando "break" gesetzt wird. Diese Test kosten 
selbstverständlich sehr viel Rechenzeit. Außerdem 
ist es oft gar nicht wünschenswert, wenn eine 
bestimmte Aktion einfach so abgebrochen wird. 
Deshalb ist die Abbruchmöglichkeit optional. Im 
Einstellungen-Dialog gibt es dafür den Schalten 
„Unterbrechbar". 

Sollten Sie jedoch in einigen Programmteilen die 
Abbruchmöglichkeit benutzen wollen und in ande¬ 
ren nicht, gibt es dafür das Pragma "break". 


#pragma break + 

schaltet das setzen der Unterbrechungspunkte ein 
und 


#pragma break - 

wieder aus. - 


Drück man bei angeschalteter Abbruchmöglichkeit 
<CTRL>+<C>, entspricht dies einem "exit(900) ". Es 
werden alle Dateien geschlossen und Speicher und 
sonstige Ressourcen freigegeben. Auch mit "atexit" 
eingehängte Funktionen werden noch ausgeführt. 
Natürlich ist ein solcher Abbruch ein Eow-Level- 
Konstrukt, so daß dabei keine Deslruktoren aufgeru¬ 
fen werden. 
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3 Referenz 


♦ 


Betriebssystemaufrufe 

Die Amiga Betriebssystem-Funktionen werden mit 
einem #pragma amicaii aufgerufen. Eine solche 
Deklaration besteht im Wesentlichen aus vier Teilen: 

- Dem Namen der Basisvariablen. 

- Dem Offset als positive Ganzzahl. 

- Dem Funktionsnamen, der bereits deklariert 
sein muß. Aus Gründen der Eindeutigkeit darf 
dieser Funktionsname nicht überladen sein. 

- Der Parameterliste, vertreten durch eine ent¬ 
sprechende Anzahl von Registernamen in run¬ 
den Klammern. 


Ein Beispiel: 

#pragma amicall(Sysbase, Oxlla, AddTask(al,a2,a3)) 
#pragma amicall(Sysbase, 0x120, RemTask(al)) 

#pragma amicall(Sysbase, 0x126, FindTask(al)) 

Solche Deklarationen werden Sie normalerweise nie 
selbst schreiben müssen, da alles mit den Amiga- 
Libraries mitgeliefert wird. 


Zeilen verbinden 

In C wie in C++ ist es absolut egal wo einzelne Zei¬ 
len enden. Beim Preprozessor dagegen ist es sehr- 
wohl relevant, denn hier muß jede Anweisung 
genau eine Zeile umfassen. Natürlich kann es dazu 
kommen, daß eine Zeile, z.B. durch eine umfangrei¬ 
che Makrodefinition, sehr lang und unhandlich 
wird. Für diesen Fall gibt es den Backslash (Gegen¬ 
schrägstrich). Wenn ein "V am Zeilenende steht, 
wird dies Zeile mit der nachfolgenden verbunden, 
z.B. so: 

#define IRGENDWAS \ 

47081115 

Dies ist eine gültige Makrodefinition, denn 
"47081115" wird hier in die vorhergehende Zeile 
gezogen. 
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Vordefinierte Symbole 

Der Preprozessor besitzt viele vordefinierte Makros. 
Dabei handelt es sich zum Teil um ANSI C genorm¬ 
te, andere sind Bestandteil von C ++ oder spezielle 
Eigenheiten von StormC. Diese Makros können 
nicht umdefiniert werden. 

_COMPMODE_ 

ist in StormC definiert mit der "int "-Konstante o im 
C-Modus und unter C ++ mit 1 . 


cplusplus 


In StormC ist das Makro "_ stdc _" sowohl im C- 

als auch im C ++ -Modus definiert. Will manin StormC 
nun explizit abprüfen, ob im C^-Modus kompiliert 

wird, muß dies mit dem Makro "_ cplusplus" 

gemacht werden. 

_DATE_ 

Das Makro_DATE_liefert das Datum der Überset¬ 

zung. Dies ist sehr nützlich, wenn man ein Pro¬ 
gramm mit einer eindeutigen Versionsnummer ver¬ 
sehen will: 


#include <stream.h> 
void main() 

{ cout « "Version 1.1 vom " _DATE_", "_TIME_" Uhr\n; > 

Das Datum wird dabei in der Form „Monat Tag 
Jahr", z.B. "Feb 08 1996", geliefert, während die Uhr¬ 
zeit ganz normal in der Form 
„Stunde:Minute:Sekunde" vorliegt. 

_FILE_ 

Dieses Makro enthält den Namen der aktuellen 
Quelltextdatei in Form eines Strings, z.B. so: 
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#include <stream.h> 
void main() 

{ cout « "Das steht in Zeile " « _LINE_ « " in der Datei 

" _FILE_ ",\n";} 

Der Wert des Makros _ file _ ist eine konstante 

Zeichenkette und kann als solche natürlich auch 
mit davor oder dahinter stehenden Zeichenketten 
verbunden werden. 

_LINE_ 

Das Makro _LINE_ liefert die Zeilennummer, in 

der es benutzt wird, als dezimale "int"-Konstante. 

_STDC_ 

Dieses Makro liefert in alles zu ANSI C kompatiblen 
Implementationen den numerischen Wert 1 und 
soll ermöglichen, festzustellen, ob ein Compiler die¬ 
sem Standard genügt, denn anderenfalls ist 
" _stdc _" nicht definiert. 

_STORMC_ 

Oft möchte man gerne testen, um welchen Compi¬ 
ler und um welche Compilerversion es sich handelt. 
Deshalb definiert StormC zusätzlich ein Makro mit 
dem Namen_ stormc _ 

_TIME 

(siehe _date_) 
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Menübefehle 


Projekt 

Neu i\-N 

Bei aktivem Piktogramm- oder Projektfenster wird 
ein neues Projekt geöffnet und entspricht damit 
einem Klick auf das Piktogramm „Neues Projekt". 

Wenn ein Editorfenster bei der Auswahl des Menü¬ 
punktes aktiv ist, wird ein neues Editfenster geöff¬ 
net. Das entspricht einem Klick auf das Piktogramm 
„Neuer Text". 

Öffnen... i\-0 

Signalisiert durch die drei Punkte am Ende des 
Menüeintrags „ Öffnen..." erscheint ein weiterer Dia¬ 
log, der auf Anwenderreaktionen wartet, bevor die 
Aktion ausgeführt wird. Im Fall von „Öffnen..." wird 
der Standard-Dateiauswahldialog (ASL-Library) zum 
Einlesen von Dateien angezeigt. Die Bedienung der 
Dialogbox sollte Ihnen bekannt sein, da sie in sehr 
vielen Programmen vorkommt. 

Je nach dem, ob das Piktogramm-/Projektfenster 
oder ein Editorfenster aktiv ist, kann entweder ein 
Projekt oder ein Text geladen werden. Die Pikto¬ 
grammleiste bietet ebenfalls zwei Piktogramme zum 
Laden von Quelltexten und Projekten. 


Sichern 

Bei aktivem Projektfenster wird das Projekt gespei¬ 
chert und entspricht damit einem Klick auf das Pik¬ 
togramm „Projekt speichern". 

Wenn ein Editorfenster bei der Auswahl des Menü¬ 
punktes aktiv ist, wird der Text gespeichert. Das ent¬ 
spricht einem Klick auf das Piktogramm „Text spei¬ 
chern". 
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Sichern als... 

Genauso wie bei der Auswahl von „Öffnen..." wird 
auch bei „Speichern als..." der Dateiauswahldialog 
angezeigt. 

Sie haben die Möglichkeit, einen Dateinamen für 
Ihr Projekt oder Ihren Text anzugeben. Die Auswahl 
per Mausklick in die angezeigte Dateiliste ist eben¬ 
falls möglich. 

Je nachdem, ob das Projektfenster oder ein Editor¬ 
fenster aktiv ist, kann entweder das Projekt oder der 
Text gespeichert werden. Die Piktogrammleiste bie¬ 
tet ebenfalls zwei Piktogramme zum Speichern von 
Quelltexten und Projekten. 


Sichern als Projektvorlage 

Dieser Menüpunkt ist nur bei aktivem Projektfenster 
anwählbar. Die Projektvorlage ist die Datei, die gela¬ 
den wird, wenn Sie ein neues Projekt entweder über 
das Menü „Projekt/Neu" oder über das Piktogramm 
„Neues Projekt" anlegen. Sie haben damit die Mög¬ 
lichkeit, eigene Einstellungen vorzugeben, die dann 
bei jedem Ihrer nächsten Projekte verwendet wer¬ 
den. 

Gespeichert werden alle Einstellungen, die Sie zum 
Projekt machen können (C/C ++ Umgebung, C/C^ 
Preprozessor, C/C ++ Optionen, C/C ++ Warnungen, 
Linker Optionen und Programmstart) und selbstver¬ 
ständlich auch alle, in dem zum Speichern vorbe¬ 
reiteten Projekt enthaltene Sektionen. 

Alles sichern 

Mit Klick auf den Menüpunkt „Alles sichern" wer¬ 
den alle angezeigten und noch nicht gesicherten 
Quelltexte und Projekte gespeichert. Sind für Quell¬ 
texte oder Projekte noch keine Dateinamen angege¬ 
ben, wird für jeden fehlenden Dateinamen die 
Dateiauswahl geöffnet. 
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Datei hinzufügen.,. 

Dieser Menüpunkt ist nur anwählbar, wenn ein Pro¬ 
jektfenster aktiviert ist. Aus der angezeigten Datei¬ 
auswahl kann eine Datei ausgewählt werden, die 
dann in das Projekt aufgenommen wird. Je nach 
Dateiendung werden verschiedene Sektionen im 
Projekt erzeugt und die Datei an die entsprechende 
Stelle im Projekt plaziert. 

Fenster hinzufügen 

Bei aktiviertem Editorfenster und angelegtem Pro¬ 
jekt wird dieser Menüpunkt zugänglich. Mit Klick 
auf „Fenster hinzufügen" wird die Datei im aktiven 
Editorfenster in die entsprechende Projektsektion 
aufgenommen. Man spart sich dadurch den Umweg 
über die Dateiauswahl, die erscheint, wenn „Datei 
hinzufügen " gewählt wird. 

Programmname wählen... 

Selbstverständlich benötigt jedes, aus mehreren 
Modulen erzeugte Programm einen Namen. Da der 
Programmname nicht anhand der Dateiendung 
ermittelt und somit automatisch in die richtige Sek¬ 
tion eingetragen werden kann, muß man ihn manu¬ 
ell angeben. Dazu wählen Sie einfach den Menüein¬ 
trag „Programmname wählen..." und geben in der 
angezeigten Dateiauswahl den entsprechenden 
Dateinamen an. Sie haben damit auch die Möglich¬ 
keit, das aus den Modulen erzeugte Programm an 
einer anderen Stelle auf Ihrer Festplatte speichern zu 
lassen, als im Projektverzeichnis. 


Schließen Ü-K 

Je nachdem, ob ein Projekt- oder Editorfenster aktiv 
ist, wird entweder das Projekt oder der Text 
geschlossen. War das Projekt oder der Text zuvor 
noch gespeichert, erscheint eine Sicherheitsabfrage 
und bietet Ihnen die Möglichkeit, dieses noch zu 
tun. 
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Das gleiche kann mit Klick auf das Schließfeld des 
jeweiligen Fensters erreicht werden. 


Über 


ln dem angezeigten Dialog finden Sie Informatio¬ 
nen zum Produkt-Copyright, unsere aktuelle Tele¬ 
fon-, Faxnummer und eine E-Mail-Adresse. 

Beenden ^-Q 

Ein Klick auf diesen Menüpunkt beendet das Ent¬ 
wicklungssystem. Sind noch Quelltexte oder Projek¬ 
te angezeigt, die noch gespeichert werden müssen, 
erhalten Sie einen entsprechenden Hinweis und die 
Möglichkeit, dies zu erledigen. 


Bearbeiten 

Markieren ^\-B 

Der Menüpunkt ist nur bei aktiviertem Editorfenster 
wählbar und schaltet den Editor-Markierungsmodus 
an oder ab. 

Ausschneiden Ü-X 

Der Menüpunkt ist nur bei aktiviertem Editorfenster 
wählbar. Der markierte Textbereich wird dabei in die 
Zwischenablage kopiert und aus dem aktiven Text 
gelöscht. Die Markierung wird ebenfalls aufgehoben. 

Kopieren Ä-C 

Der Menüpunkt ist nur bei aktiviertem Editorfenster 
wählbar. Anders als beim Ausschneiden wird mit 
Kopieren der markierte Textbereich lediglich in die 
Zwischenablage kopiert aber nicht aus dem aktiven 
Text gelöscht. 

Einfügen ^-V 

Der Menüpunkt ist nur bei aktiviertem Editorfenster 
wählbar. Dabei wird der in der Zwischenablage 
befindliche Text ab der Stelle des Textcursors in den 
aktiven Text eingefügt. 
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Löschen 

Bei aktivem Editorfenster wird der markierte Textbe¬ 
reich aus dem Text entfernt. Der gelöschte Text wird 
nicht in die Zwischenablage kopiert. Das Textlö¬ 
schen kann jedoch mit „Undo" rückgängig gemacht 
werden. 


Bei aktivem Projektfenster wird das in einer Sektion 
markierte Modul aus dem Projekt entfernt. Ein 
„Undo" ist hierbei nicht möglich. 


Undo /krJ. 

Der Menüpunkt ist nur bei aktiviertem Editorfenster 
wählbar. Mit „Undo" wird die zuletzt ausgeführte 
Editorfunktion zurückgenommen. 

Redo ^\-R 

Der Menüpunkt ist nur bei aktiviertem Editorfenster 
wählbar. Mit „Redo" wird das zuletzt ausgeführte 
„Undo" zurückgenommen. 


Finden & Ersetzen... ^Ü-F 

Finden & ersetzen ist selbstverständlich nur bei akti¬ 
vem Editor-Fenster wählbar. Wie die drei Punkte 
nach dem Menüeintrag symbolisieren, wird hierbei 
ein Dialog angezeigt, in dem der Suchbegriff und 
das Wort, durch das ersetzt werden soll, eingegeben 
werden können. 


□ 1 /Beispiele/'CQlorwheel/CQlQrWheel.c 


lalca 



Finde | Strom C 


Ersetze durch IStormC 

c\ 

Vorwärts | 

J ignoriere Groß/Kleinschreibung 

ci 

Text j 

J ignoriere Akzente 


Finden 


Ersetzen 


Alle ersetzen | 


^aJ 
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Die Funktion kann natürlich auch nur zum Suchen 
verwendet werden. Lassen Sie hierzu einfach den 
Ersetzen-Begriff frei und klicken auf das Symbol 
„Finden". 

Zusätzlich kann die Suchrichtung ab der Cursorposi¬ 
tion angegeben werden. Es besteht aber auch die 
Möglichkeit immer den kompletten Text durchsu¬ 
chen zu lassen, egal an welcher Stelle gerade der 
Textcursor positioniert ist. 

Mit der Auswahl einer Spezifiktaion aus dem Cycle- 
Menü darunter lassen sich die Suchparameter exak¬ 
ter definieren. 

Mit den rechts daneben angebrachten Symbolen 
zum Abhaken, kann eingestellt werden, daß die 
Groß-/Kleinschreibung und eventuell enthaltene 
Akzente nicht beachtet werden sollen. 


Mit den drei Symbolen am unteren Rand des Dia¬ 
logs führen Sie die gemachten Anweisungen auf ver¬ 
schiedene Weise aus. 

„Finden" sucht lediglich den im Finde-Textsymbol 
eingegebenen Begriff. 

„Ersetzen" ersetzt den Finde-Begriff durch den 
Ersetze-Begriff einmalig. 

„Alle ersetzen" ersetzt alle gefunden Finde-Begriffe 
durch den Ersetze-Begriff. 


Finde nächstes 

Das Menü kann nur bei aktivem Editor-Fenster aus¬ 
gewählt werden. 

„Finde nächstes " führt die zuletzt gemachte Finde - 
Anweisung aus, ohne zuvor den Dialog zu öffnen. 

Ersetze nächstes M - M 

Das Menü kann nur bei aktivem Editor-Fenster aus¬ 
gewählt werden. 

„Ersetze nächstes" führt die zuletzt gemachte Erset- 
ze-Anweisung aus, ohne zuvor den Dialog zu öffnen. 
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Kompilieren... 

Der Menüpunkt „ Kompilieren..." ist anwählbar, 
wenn in der Projektsektion Quelltexte ein Eintrag 
markiert ist. Er kann auch dann angewählt werden, 
wenn der im aktiven Quelltexteditor-Fenster ange¬ 
zeigte Quelltext im aktiven Projekt enthalten ist. 

Mit dieser Funktion können Sie einzelne Module 
gezielt kompilieren lassen. 

Make... Ü-M 

Der Menüpunkt ist nur bei aktiviertem Projekt- oder 
Fehlerfenster wählbar. Er kann auch dann ange¬ 
wählt werden, wenn der im aktiven Quelltexteditor- 
Fenster angezeigte Quelltext im aktiven Projekt ent¬ 
halten ist. 

Mit Make werden alle Module kompiliert, die seit 
dem letzten Kompilieren verändert wurden. Dabei 
werden auch Abhängigkeiten zwischen Programm¬ 
und Header-Dateien berücksichtigt. 

Ein Klick auf das Piktogramm „Make" hat dieselbe 
Auswirkung. 

Starten... 

Der Menüpunkt ist nur bei aktiviertem Projekt- oder 
Fehlerfenster wählbar. Er kann auch dann ange¬ 
wählt werden, wenn der im aktiven Quelltexteditor- 
Fenster angezeigte Quelltext im aktiven Projekt ent¬ 
halten ist. 

Falls für das aktuelle Projekt bereits ein ausführbares 
Programm erzeugt wurde, wird dieses gestartet. 
Zuvor wird ein „Make" ausgeführt und damit auto¬ 
matisch alle veränderten Module neu kompiliert 
und auch das Programm neu erzeugt. 

Das selbe kann auch mit Klick auf das Piktogramm 
„Run" erreicht werden. 
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Debug... S\-D 

Der Menüpunkt ist nur bei aktiviertem Projekt- oder 
Fehlerfenster wählbar. Er kann auch dann ange¬ 
wählt werden, wenn der im aktiven Quelltexteditor- 
Fenster angezeigte Quelltext im aktiven Projekt ent¬ 
halten ist. 

Mit Klick auf „ Debug..." wird praktisch ein „Star¬ 
ten..." ausgeführt und automatisch der Debugger 
gestartet. Der Programmzähler wird auf die erste 
Funktion (main) im Programm gesetzt und die Pro¬ 
grammausführung angehalten. 

Das selbe kann auch mit Klick auf das Piktogramm 
„Debug" erreicht werden. 

Berühren (engl, touch) 

Der Menüpunkt ist nur bei aktiviertem Projektfen- 
ster wählbar. 

Mit Klick auf den Menüpunkt „Berühren" wird der 
markierte Eintrag in der Quelltext-Sektion als verän¬ 
dert markiert. Bei dem nächsten Starten von „Make" 
wird dieser Quelltext garantiert neu kompiliert. 

Alles berühren (engl, touch all) 

Der Menüpunkt ist nur bei aktiviertem Projektfen¬ 
ster wählbar. 

Hierbei werden alle Module in der Quelltext-Sektion 
als verändert markiert. Bei dem nächsten Starten 
von „Make" wird jedes Modul des Projektes neu 
kompiliert. 

Programm sichern als... 

Der Menüpunkt ist nur bei aktiviertem Projekt- oder 
Fehlerfenster anwählbar. 

Nach dem erfolgreichen Linken wird das Programm 
prinzipiell gespeichert. Wenn kein Programmname 
im Projekt vorgegeben ist, wird das Programm unter 
dem Namen A.Out in das Verzeichnis gespeichert, in 
welches das Projekt gespeichert wurde. 

Mit dem Menüpunkt „Programm sichern als..." 
haben Sie nun die Möglichkeit, eine Kopie des 
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erzeugten Programmes unter anderem Namen an 
einer anderen Stelle auf Ihrer Festplatte zu spei¬ 
chern. 


Fenster 

Fehlerfenster... 

Der Menüpunkt ist nur bei aktiviertem Projektfen- 
ster wählbar. 

Das Fehlerausgabefenster wird geöffnet. 

Module... 

Der Menüpunkt ist nur bei gestartetem Debugger 
aktiv und öffnet das Fenster der Programmodule, für 
die Quellinformationen ausgegeben werden kön¬ 
nen. Prinzipiell handelt es sich dabei um die gleiche 
Liste von Einträgen, wie sie im Projektfenster unter 
Quelltexte erscheint, wenn für jeden Quelltext auch 
eine Debuggerausgabe erzeugt wurde. Es werden 
lediglich statt der Quelltextenamen die Dateinamen 
der Objektmodule angezeigt. 

Aktuelle Variablen... 

Der Menüpunkt ist nur bei gestartetem Debugger 
aktiv und öffnet das Fenster für die Anzeige der 
aktuellen Variablen. 

Überwachte Variablen... 

Der Menüpunkt ist nur bei gestartetem Debugger 
aktiv und öffnet das Fenster für die Anzeige der 
überwachten Variablen. 

Einstellungen 

Projekt... 

Die Einstellungen zum jeweiligen Projekt werden bei 
aktiviertem Projekt- oder Fehlerfenster zugänglich. 
Bei Klick auf das Menü „Projekt..." wird der abgebil¬ 
dete Dialog angezeigt. 
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Indude-Pfade und vorkompilierte Header 



Der erste Einsteller in der Liste der Einstellerdialoge 
ist der für die Include-Dateien. Aus den Include- 
Dateien liest der Preprozessor seine Definitionen für 
z. B. die Standard-Funktionen. In Ihrem Quelltext 
benutzen Sie zum Einbinden solcher Dateien die 
Preprozessor-Anweisung #inciude. Vielleicht wissen 
Sie schon, daß man dabei zwei Möglichkeiten hat: 
Schließt man den Dateinamen nach dem ttinicude 
"so" in Anführungszeichen ein, sucht der Preprozes¬ 
sor (das Programmodul, das vor dem Compiler die 
Datei bearbeitet) vom aktuellen Verzeichnis aus, 
während die <so> in spitze Klammern gesetzten Dat¬ 
einamen Standard-Includedateien bezeichnen und 
in vorgegebenen Verzeichnissen gesucht werden. In 
dem Listview können Sie für die Standard-Include¬ 
dateien mehrere Verzeichnisse vorgeben. 

Mit dem „kopieren nach:"-Gadget, haben Sie die 
Möglichkeit einen Kopierpfad für die Dateien anzu¬ 
legen. Um die Compilergeschwindigkeit zu steigern 
sollte der hierbei angegebene Pfad in der RAM-Disk 
liegen, da anderenfalls kein Geschwindigkeitsvorteil 
zu erwarten ist. Daß Sie über genügend Speicherre¬ 
serven verfügen sollten, muß ich Ihnen hoffentlich 
nicht sagen. 

Eine weitere Möglichkeit, um Speicher zu sparen 
und die Compilergeschwindigkeit zu erhöhen, 
haben Sie durch die Erzeugung von vorkompilierten 
Header-Dateien. Damit der Compiler weiß, wo die 
Header aufhören und Ihr eigenes Programm 
beginnt, muß die Stelle mit einer "#pragma header" 
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Zeile markiert sein. Am einfachsten schreiben Sie in 
den Quelltext jedes Moduls zunächst die "#inciu- 
des" aller Header-Dateien, die Sie nicht selbst 
geschrieben haben oder die sowieso nicht geändert 
werden, wie z. B. die OS-Includes. Dann folgt die 
Zeile "#pragma header". Hiernach können Sie dann 
mit Ihren eigenen Headerdateien und den Rest des 
Programmes angeben. 

Die Pragma-Anweisung hat solange keine Wirkung, 
bis Sie im Einsteller das Header-Cycle-Menü auf 
"Headerdatei schreiben” einstellen und die verän¬ 
derten Module neu kompilieren. Sobald der Compi¬ 
ler die Pragma-Anweisung im Programm erreicht, 
dauert es eine kurze Zeit und die vorkompilierten 
Header-Dateien werden unter dem angegebenen 
Namen in das entsprechende Verzeichnis geschrie¬ 
ben. 

Vor dem nächsten Compilerlauf schalten Sie dann 
einfach auf „Headerdatei lesen". Der Compiler liest 
dann die vorkompilierte Headerdatei, sucht nach 
der Anweisung "#pragma header" und setzt dort mit 
seiner Übersetzung ein. 

Um auf den nächsten Einsteller wechseln zu kön¬ 
nen, müssen Sie sich des Cycle-Menüs am oberen 
Rand des Dialogfensters bedienen. 



Schaltet auf den nächsten Dialog. 


Zeigt ein Popup-Menü und Sie können aus der 
Liste der Möglichkeiten wählen. 
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Preprozessor 



Mit diesem Dialog können Sie zum einen die Pre¬ 
prozessor-Warnungen einstellen und zum zweiten 
die Preprozessor-Symbole vordefnieren. 

Zu den Warnungen muß ich sicher nichts beschrei¬ 
ben wohl aber zu den Definitionen. |eder I intrag, 
der in das Listview gemacht wird, wiikt heim (,om- 
pilieren so, als stände er mit einem voungcstellten 
"#def ine" am Anfang jedes iihersei/len Ouelltextes. 
Sie können so global wirkende Dellnillonen «inge¬ 
ben wie Z. B. Debug und als Token Ti u« <>dei Fn 1 se. 


Codegenerierung und Debuggn 



Dieser Dialog stellt alle l inMellui..\ .ihigung, 

die für die Codegeneriem ng und d> n i »• hurrei n ie 
vant sind. Angefangen mit d< i \n .I. » >n< Westes 
(ANSI C oder C") kann zu »i 11« h im i Modus 
noch die Verarbeitung von l* mpl.in und die 
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Benutzung des Exception-Handlings eingeschaltet 
werden. 

Unter der Quelltextsteuerung befinden sich die Ein¬ 
steller für die Debuggerausgabe. 

Zuerst wählen Sie mit dem Cycle-Menü, ob über¬ 
haupt Debug-Ausgaben erzeugt werden sollen. Der 
Compiler generiert dann zusätzlich Debug-Dateien 
mit der Endung n .debug" und ".link". Diese Datei¬ 
en werden vom Debugger benötigt, um den Bezug 
zwischen Quelltext und Programmcode herstellen 
zu können. 

Sollten Sie lieber mit einem symbolischen Debugger 
/Disassembler arbeiten wollen, haben Sie die Mög¬ 
lichkeit, einen Symbolhunk an das Programm 
anhängen zu lassen. 

Für diejenigen unter Ihnen, die lieber manuell kon¬ 
trollieren möchten, was der Compiler so alles gene¬ 
riert, ist die Erzeugung von Assembler-Quelltexten 
aus den C/C ++ -Codes möglich. Der Compiler schreibt 
dann außer der n .o"-Datei noch eine s"-Datei, die 
den Assembler-Quelltext wahlweise gemischt mit C- 
Quelltext enthält. 

Mit der Wahl des Symbols „Codegenerierung 
unterbrechbar" erzeugt der Compiler in jeder 
Schleife eine Abfrage der Tastenkombination 
<CTRL>+<C>. 

Wenn Sie Code für den 68000er erzeugen, sollten Sie 
den Schalten „32 Bit Multiplikation" einschalten, 
da dann die korrekt funktionierenden Bibliotheks¬ 
funktionen zur Langwortdivision und -multiplika- 
tion genutzt werden. Bei der Erzeugung von Code 
für die höheren Prozessoren ist dieser Schalter 
sowieso bedeutungslos. 

Bei eingeschaltetem Schalter „Code optimieren", 
wird der Programmcode kürzer und meist auch 
schneller. 

Mit dem Cycle-Menü darunter sind die verschiede¬ 
nen Prozessoren einstellbar, für die spezieller Code 
erzeugt werden kann. Hierbei müssen Sie die 
Abwärts-Inkompatibilität beachten. Wenn Sie zum 
Beispiel Code für den 68030 erzeugen lassen, ist das 
Programm nicht mehr auf einem handelsüblichen 
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Amiga 1200 lauffähig, da dieser mit einem 68020 
Prozeossor bestückt ist. 

Das Cycle-Menü darunter läßt Ihnen die Wahl zwi¬ 
schen FPU-Code oder dem Aufruf der Systembiblio¬ 
theken bei mathematischen Berechnungen in 
Ihrem Programm. 

Das letzte Cycle-Menü in dieser Reihe schaltet zwi¬ 
schen großem und kleinen Datenmodell um. 


Warnungen 



In StormC gibt es 8 Warnungen, die man je nach 
Situation und persönlichem Programmicrslil einzeln 
ein- und ausschalten kann. 
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Menüleisten, Dialoge,.. 


Linker Einstellungen 


' ♦ 



Ähnlich wie für Include-Dateien bei den Preprozes¬ 
sor-Einstellungen läßt sich auch der Pfad für die Lin¬ 
kerbibliotheken einstellen. 

Ist im Cycle-Menü darunter die Einstellung „Pro¬ 
gramm linken" gewählt, wird das übersetzte Pro¬ 
gramm ganz normal mit den Bibliotheksroutinen zu 
einem ausführbaren Programm zusammengebun¬ 
den. 

Ist „Nicht linken" eingeschaltet, werden keinerlei 
Bibliotheks- oder sonstige Module hinzugeladen. 
Der Linker wird überhaupt nicht gestartet. 

Bei „Ohne Statup-Code linken", wird das Pro¬ 
gramm so gelinkt, daß es beispielsweise als „Shared- 
Library" oder als „Device-Treiber" eingesetzt werden 
kann. Einen Start solcher Programme von der Work- 
bench oder vom CLI aus ist nicht möglich. 

Im Fehlerfall kann mit dem Cycle-Menü darunter 
festgelegt werden, ob der Linkvorgang gestartet oder 
nicht gestartet werden soll. 


49 


StormC Benutzerhandbuch 


























3 Referenz 


♦ 


Programmstort 



Selbstverständlich muß die Möglichkeit bestehen, 
für den Start aus der integrierten Umgebung Argu¬ 
mente anzugeben und die Stackgröße des Program¬ 
mes vorgeben zu können. 


Einstellungen laden... 

Der Menüpunkt ist nur bei aktivem Debugger 
anwählbar. Mit dem angezeigten ASL-Dateidialog 
kann eine Debugger-Settings-Datei mit der Endung 
" .run" gelanden werden. 

Einstellungen sichern 

Der Menüpunkt ist nur bei aktivem Debugger 
anwählbar. Sie können hiermit die komplette 
Debugger-Konfiguration (welche Fenster geölt net 
sind und deren Position) speichern. Gespeichert 
wird in das Verzeichnis aus dem StromC gestartet 
wurde unter dem Namen "StormSettings.Run" 

Einstellungen sichern als... 

Der Menüpunkt ist nur bei aktivem Debugger 
anwählbar. Es wird die gleiche Konfiguration wie bei 
„Einstellung sichern" gespeichert mit dem Unter¬ 
schied, daß der ASL-Dialog erscheint und Sie einen 
beliebigen Dateinamen und Dateipfad angeben kön¬ 
nen. 
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Lizenzvereinbarungen 


♦ 


Lizenzvereinbarungen 

1 Allgemeines 

(1) Gegenstand dieses Vertrages ist das Benutzungsrecht für Computerprogramme der HAAGE & PARTNER 
Computer GmbH, für die Benutzungsanleitung sowie für sonstiges zugehöriges, schriftliches Material, 
nachfolgend zusammenfassend als Produkt bezeichnet. 

(2) Die HAAGE & PARTNER Computer GmbH und/oder die in dem Produkt angegebenen Lizenzgeber sind 
Inhaber sämtlicher Rechte an den Produkten und Warenzeichen. 

2 Nutzungsrechte 

(1) Der Käufer erhält ein nicht übertragbares, nicht ausschließliches Recht, das erworbene Produkt auf einem 
Computer bzw. an einem Arbeitsplatz zu nutzen. 

(2) Darüber hinaus kann der Anwender eine einzige Kopie zu Sicherungszwecken anfertigen. 

(3) Der Käufer ist nicht berechtigt, das erworbene Produkt zu vertreiben, zu vermieten, Dritten Unterlizenzen 
anzubieten oder diese in anderer Weise Dritten zur Verfügung zu stellen. 

(4) Es ist verboten, das Produkt zu ändern, zu modifizieren oder anzupassen oder in jeglicher Form rückzuent¬ 
schlüsseln. Dieses Verbot gilt auch für das Übersetzen, Abwandeln, Rückentschlüsseln und Weiterverwen¬ 
den von Teilen. 

3 Gewährleistung 

(1) Die HAAGE & PARTNER Computer GmbH gewährleistet, daß zum Zeitpunkt der Lieferung die Datenträger 
physikalisch frei von Material- und Herstellungsfehlern sind und das Produkt wie in der Dokumentation 
beschriebenen Weise genutzt werden kann. 

(2) Mängel des gelieferten Produkts werden vom Lieferanten innerhalb der Gewährleistungsfrist von sechs 
Monaten ab Lieferung nach entsprechender Mitteilung durch den Anwender behoben. Dies geschieht 
nach Wahl des Lieferanten durch kostenfreie Nachbesserung oder durch Ersatzlieferung in Form eines 
Updates. 

(3) Die HAAGE & PARTNER Computer GmbH übernimmt keine Haftung dafür, daß das Produkt für die vom 
Kunden vorgesehene Aufgabe geeignet ist. Für eventuell auftretende Folgeschäden übernimmt die HAAGE 
& PARTNER Computer GmbH keine Haftung. 

(4) Der Anwender weiß, daß nach dem heutigen Stand der Technik die Erstellung völlig fehlerfreier Software 
nicht möglich ist. 

4 Sonstiges 

(1) In diesem Vertrag sind sämtliche Rechte und Pflichten der Vertragsparteien geregelt. Sonstige Vereinbarun¬ 
gen bestehen nicht. Änderungen sind nur in Schriftform und bei Bezugnahme auf diesen Vertrag wirksam 
und beiderseitig zu unterzeichnen. 

(2) Der Gerichtsstand für alle Streitigkeiten aus diesem Vertrag ist, soweit vereinbar, das zuständige Gericht am 
Firmensitz der HAAGE & PARTNER Computer GmbH. 

(3) Sollten einzelne Bestimmungen dieser Bedingungen nicht rechtswirksam sein oder ihre Rechtswirksamkeit 
durch einen späteren Umstand verlieren, oder sollte sich in diesen Bedingungen eine Lücke heraussteilen, 
so wird hierdurch die Rechtswirksamkeit der übrigen Bestimmungen nicht berührt. Anstelle der unwirksa¬ 
men Vertragsbestimmungen oder zur Ausfüllung der Lücke soll eine angemessene Regelung gelten, die, 
soweit rechtlich möglich, dem am nächsten kommt, was die Vertragsparteien gewollt haben, soweit sie 
von der Unwirksamkeit der Bestimmung Kenntnis gehabt hätten. 

(4) Jede Verletzung vorstehender Lizenzbestimmungen oder von Urheber- und Warenzeichenrechten wird 
straf- und zivilrechtlich verfolgt. 

(5) Durch Installation der Software werden diese Lizenzvereinbarungen anerkannt. 

(6) Sind Sie mit den Lizenzvereinbarungen nicht einverstanden, so müssen Sie das Produkt unverzüglich 
gegen Erstattung bereits geleisteter Zahlungen an den Lieferanten zurückgeben. 

Stand: September 1995 
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StormC AMIGA -Entwicklungs-System 

Das vielseitige Programmiersystem für Sie und Ihren Amiga! 


StormC beinhaltet alle Entwicklungswerkzeuge; die zum effizienten Entwickeln unerläßlich sind. 
Dazu gehören: 


# der sehr schnelle Quelltext-Editor , der Schlüsselworte und Syntaxeigenschaften farbig 
hervorheben kann. Eine perfekte Quelltext-Strukturierung erhöht die Produktivität. 

# der Hochgeschwindigkeits ANSI-C/C ++ Compiler. Er generiert Code für alle Prozessoren 
der Motorola 68000-Familie einschließlich 68060, 68881/68882 und nutzt alle Vorteile 
dieser schnellen Prozessor-Chips. 

% die flexible Projektverwaltung. Mit ihr verwirklichen Sie die komplexesten Aufgaben 
innerhalb kürzester Zeit. 


".-irit '-w Sc rm 
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:*( das compksrl« Programm 


% die RunShell eröffnet vollkommen neue Möglichkeiten bei der Software-Entwicklung auf 
dem Amiga. Von ihr wird ein „Resource Tracking" durchgeführt, so daß Programmierfehler 
in einem Stadium entdeckt werden, in dem es bislang keine Lösungen gab. 

% der besonders komfortable Source-Level-Debugger kann auch während der Laufzeit 
über die RunShell gestartet werden. Sie müssen sich nicht vor dem Programmstart 
entscheiden, ob Sie nun debuggen oder das Programm einfach nur testen. Mit der 
Debugger-Eigenschaft, die Quelltexte im normalen Editor anzeigen zu können, bleiben 
die Farbmarkierung und Ihre Strukturierung voll erhalten. 

# die umfangreichen Funktions- 
Bibliotheken zu ANSI-C, C ++ 
und den Amiga Betriebssy¬ 
stem-Funktionen sind genau¬ 
so Bestandteil wie die neuen 
System-Include- Dateien. 

# Systemvoraussetzungen: 

Computertyp: 

alle Amiga-Modelle mit 
Festplatte 

Betriebssystem: 

AmigaOS 2.0 und höher 

Speicher: 

3 MB Hauptspeicher (einige 
Funktionen können nur mit 
min. 6 MB Hauptspeicher 
genutzt werden) 
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Irrtümer und Änderungen Vorbehalten. Die HAAGE & PARTNER Computer GmbH übernimmt keine Gewähr lür die 
Mängelfreiheit des Produktes. Der Lizenznehmer verzichtet auf jegliche Gewährleistunasansprüche. Mit dem Offnen 
der Verpackung werden diese Bedingungen anerkannt. Amiga ist ein eingetragenes Warenzeichen der ESCOM AG. 


HAAGE & PARTNER 
Computer GmbH 
Mainzer Str. 10A 



61191 Rosbach v.d.H. 


Tel: 0 60 07/93 00 50 
Fax: 0 60 07/75 43 
CompuServe: 100654,3133 


























































